---
title: "MentraOS Cloud Documentation"
description: "Internal documentation for MentraOS Cloud development"
---

## Welcome to MentraOS Cloud

This is the internal documentation for developers working on the MentraOS Cloud codebase. Here you'll find detailed information about the cloud architecture, services, managers, and how to set up your development environment.

<Card
  title="Cloud Architecture Overview"
  icon="cloud"
  href="/cloud-overview/introduction"
  horizontal
>
  Understand how the cloud orchestrates communication between glasses, mobile apps, and third-party applications.
</Card>

## Getting Started

Essential resources for cloud development.

<Columns cols={2}>
  <Card
    title="Local Development Setup"
    icon="laptop"
    href="/development/local-setup"
  >
    Run the cloud locally with Docker, ngrok, and connect your mobile app.
  </Card>
  <Card
    title="Authentication Flow"
    icon="shield"
    href="/cloud-overview/authentication-flow"
  >
    Understand JWT authentication and session management.
  </Card>
  <Card
    title="User Sessions"
    icon="users"
    href="/cloud-overview/user-sessions"
  >
    Learn about UserSession - the core entity managing connections.
  </Card>
  <Card
    title="Message Types"
    icon="message"
    href="/cloud-overview/message-types"
  >
    All message types flowing between glasses, cloud, and apps.
  </Card>
</Columns>

## Core Architecture

Deep dive into the cloud's internal structure.

<Columns cols={3}>
  <Card title="WebSocket Service" icon="plug" href="/cloud-architecture/services/websocket-service">
    Routes connections between glasses and apps
  </Card>
  <Card title="Session Service" icon="server" href="/cloud-architecture/services/session-service">
    Orchestrates UserSession lifecycle
  </Card>
  <Card title="UserSession Class" icon="user" href="/cloud-architecture/session-management/user-session-class">
    The heart of the system - manages everything
  </Card>
  <Card title="Managers Pattern" icon="puzzle" href="/cloud-architecture/managers/overview">
    Specialized managers for different concerns
  </Card>
  <Card title="Subscription Service" icon="bell" href="/cloud-architecture/services/subscription-service">
    Controls data flow to apps
  </Card>
  <Card title="Message Types" icon="message" href="/cloud-overview/message-types">
    All SDK types and interfaces
  </Card>
</Columns>

## Manager Documentation

Detailed guides for each UserSession manager.

<Columns cols={2}>
  <Card
    title="App Manager"
    icon="cube"
    href="/cloud-architecture/managers/app-manager"
  >
    App lifecycle, webhooks, and resurrection
  </Card>
  <Card
    title="Audio Manager"
    icon="volume"
    href="/cloud-architecture/managers/audio-manager"
  >
    Audio processing and distribution
  </Card>
  <Card
    title="Display Manager"
    icon="monitor"
    href="/cloud-architecture/managers/display-manager"
  >
    Display throttling and prioritization
  </Card>
  <Card
    title="Transcription Manager"
    icon="microphone"
    href="/cloud-architecture/managers/transcription-manager"
  >
    Multi-provider speech-to-text
  </Card>
</Columns>

## Join the Community

<Columns cols={2}>
  <Card
    title="Discord"
    icon="discord"
    href="https://discord.gg/5ukNvkEAqT"
  >
    Chat with other developers and get help from the team.
  </Card>
  <Card
    title="GitHub"
    icon="github"
    href="https://github.com/Mentra-Community/MentraOS"
  >
    Contribute to MentraOS and see the source code.
  </Card>
</Columns>